home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / utils / spmorf19 / spmorf.doc < prev    next >
Text File  |  1994-09-13  |  13KB  |  291 lines
  1. SPMORF 1.9 (9/13/94) Documentation
  2. Copyright (c) 1994
  3.  
  4. ---- What is SPMORF? ----
  5. SPMORF is a high speed morphing program which runs
  6. in DOS. It supports GIF and 24-bit TGA files as input
  7. and outputs 24-bit TGA files. To combine the TGA files
  8. into an animation, you will need another program
  9. which accepts TGA files as input such as Dave's
  10. Targa Animator (DTA) which can be found on most
  11. Bulletin Boards.
  12. ** REGISTERED VERSION OF SPMORF NOW SUPPORTS FLI OUTPUT!
  13.  
  14. ---- Hardware Requirements ----
  15.   386 or greater
  16.   At least 1mb EMS memory
  17.   VGA/SVGA (VESA Compatible)
  18.   Microsoft compatible mouse
  19.   *Math coprocessor is supported and recommended
  20.  
  21. SPMORF is a shareware program. You are free to test this
  22. program and judge it's value. If you think that it's a good
  23. piece of software, please register it. If you register, you
  24. will recieve the following:
  25.  
  26.      -Registered Version of SPMORF 1.9 that supports input images larger
  27.       than 320x200 and FLI OUTPUT!
  28.      -Version 2.0 which will have the following enhancements (I hope!)
  29.  
  30.         * Speed enhancements when morphing with resampling turned on
  31.         * Advanced mesh editing (Moving mesh lines, etc.)
  32.         * Precise control over fading and warping (Using splines)
  33.         * Built in image and animation viewer
  34.         * More warping effects (Wave morph, pinch/punch warp, etc. )
  35.  
  36.      -High resolution flic player
  37.      -More sample images and meshes
  38.  
  39. The registration fee is only $20. I consider this  good deal since
  40. commercial packages can cost well over $100. Also, I'm going through
  41. school so just think about how much you are helping me out when you
  42. send in your registration :)
  43.  
  44. To register send $20 (Or more if you wish!) to:
  45.  
  46.        Scott H. Pultz
  47.        114-168th AVE NE
  48.        Bellevue, WA
  49.        98008
  50.  
  51. I would prefer money orders, but you can send a personel check if you like.
  52. Please specify disk size 3 1/2 or 5 1/4 and include ANY E-MAIL addresses
  53. in which you can be reached. (Internet, AOL, Prodigy, etc.)
  54.  
  55. NOTE: I'm thinking of making a fully illustrated documentation for registered
  56.       users. Will you please tell me if it would be of any value to you?
  57.       See how to contact me at the end of this documentation.
  58.  
  59. ---- Loading SPMORF ----
  60. To load SPMORF, type:  SPMORF infile outfile <options>
  61.  
  62. infile and outfile specify the before and after pictures. They can
  63. be either GIF or 24-bit TGA files. Run-length encoded TGA files are
  64. supported. Images can be different resolutions. If the resolution is
  65. not specified (See below) the resolution of the first image is used.
  66.  
  67. OPTIONS:
  68.  
  69. /1024    Use 1024x768x256c video mode
  70. /800     Use 800x600x256c  video mode
  71. /640     Use 640x480x256c  video mode
  72. /640-16  Use 640x480x16c   video mode
  73.  
  74. /RX      Specify horizontal resolution
  75. /RY      Specify vertical resolution
  76. /C       Display images in color
  77. /R       Resample images when morphing
  78. /F       Generate .FLI from TGA files
  79. /NORLE   Don't compress TGA files
  80. /T       Text display during morphing (Use with OS/2 or Windows)
  81. /S       Use spline meshes when morphing
  82. /SF      Display full spline detail
  83. /P       Specifies the spline precision. The default is 3, and it should
  84.          be left there for most meshes.
  85.  
  86. SPMORF loads the images into EMS memory to increase speed. The amount of EMS 
  87. memory needed depends on the resolution of the input images.
  88. For a 320x200 image, 1062k bytes of EMS memory is required.
  89.  
  90. SPMORF will auto-detect your graphics adapter. To run SPMORF in with
  91. 256 colors, you will need a graphics adapter with the VESA BIOS
  92. extentions. Most SVGA adapters come with a TSR which makes them VESA
  93. compatible. If you have a standard VGA card, 640x480 with 16 colors is
  94. used.
  95. Note: There is a minor bug when dithering VGA images but it will be worked on.
  96.  
  97. ---- Using SPMORF ----
  98. After SPMORF loads you should see two images side-by-side. The left one
  99. is the before picture and the right one is the after picture.
  100.  
  101. SPMORF uses a mesh to define the morphs. Good quality morphs require that
  102. you create good quality meshes. To insert lines into the mesh, click the
  103. right button on the border of the image. You will notice that lines appear
  104. on both images. To stretch the mesh, click the left button on the intersection 
  105. of two lines. Create a mesh around the significant parts of the left image.
  106. Then move the coresponding points of the right image to the coresponding
  107. location. For example, if you were morphing a human face into an eagle, you
  108. would create a mesh around the facial features (Eyes, nose, mouth, etc.) and
  109. move them to the coresponding parts of the eagle's face.
  110.  
  111. After creating a mesh, save it by clicking on the button <SAVE> (See Below)
  112. You can then reload the mesh by clicking on the button <LOAD> (See Below)
  113.  
  114. When you are all through with creating your mesh, click on the <MORF>
  115. button. SPMORF will then create the output TGA files. 
  116.   *You can also click on <PREVIEW> to get a quick look at your morph!
  117.  
  118. Clicking the left and right mouse buttons at the same time will redraw the
  119. two images and the meshes.
  120.  
  121. ---- SPMORF commands ----
  122. LOAD        - This command loads a mesh file. A list box will appear. The list
  123.               on the left is the directory of which the mesh file you wish to
  124.               load is, and the list on the right are the mesh files with an
  125.               extention of .MSH. Select a mesh file and either click on <Okay>
  126.               or click on the highlighted file again to load it.
  127.  
  128. SAVE        - The save command saves your mesh into a file. First select the
  129.               directory which you want to save the mesh file in then click on
  130.               <Okay>. Type in the mesh filename but DO NOT add an extention
  131.               because .MSH is added automatically!
  132.             
  133.  
  134. QUIT        - This quits SPMORF.
  135.  
  136. MORF        - The MORF command creates the output TGA files.
  137.  
  138. PREVIEW     - The PREVIEW command generates a 1/4 screen animation of your
  139.               morph at very high speeds. To see your animation, use the controls
  140.               on the bottom of the preview screen. Press <ESC> to return to the
  141.               main screen. The right mouse button stops playback of your
  142.               animation
  143.  
  144. NEW         - This will clear the current mesh and start all over
  145.  
  146. ZOOM 1      - This zooms into the left image.
  147.  
  148. ZOOM 2      - This zooms into the right image.
  149.  
  150. COPY 1->2   - This copys the mesh from the left image to the right.
  151.  
  152. COPY 2->1   - This copys the mesh from the right image to the left.
  153.  
  154. SWAP 1&2    - This swaps the left and right meshes
  155.  
  156. Oops!       - This will allow you to undo the last mesh line added
  157.  
  158. OPTIONS     - Brings up the options dialog box (See below)
  159.  
  160. MESH COLOR  - Changes the color of the mesh
  161.  
  162. SHOW SPLINE - Displays what the spline mesh would look like
  163.  
  164. REDRAW      - Redraws the images and meshes
  165.  
  166. WARP        - Switches to warp only mode (See below)
  167.  
  168. ---- SPMORF switches ----
  169. Total Frames - This represents how many frames make up the morph. Click
  170.                on the number with the right mouse button to increase
  171.                the number of frames and click with the left button to
  172.                decrease the number of frames.
  173.  
  174. Start Frame  - This is the first frame which is morphed. For example,
  175.                it the start frame is set at 5, the first 4 frames are
  176.                skipped. Changing the start frame value is the same as
  177.                changing the total frames.
  178.  
  179. End Frame    - This is the last frame which is to be morphed. Use the same
  180.                process to change the end frame as used in changing the
  181.                total number of frames.
  182.  
  183. 50% Fade     - Specifies what percentage of morph that 50% of the images have
  184.                been faded. A low value such as 25 means that the images are
  185.                faded earlier on in the morph and high values mean that they
  186.                are faded towards the end of the morph
  187.  
  188. 50% Warp     - Specifies what percentage of morph that 50% of the images have
  189.                been warped. A low value such as 25 means that the images are
  190.                warped earlier on in the morph and high values mean that they
  191.                are warped towards the end of the morph
  192.  
  193. ---- Options dialog ----
  194. These are the switches which appear when the options dialog is selected.
  195.  
  196. Output Directory              - This button brings up a dialog box which
  197.                                 allows you to specify where the TGA files
  198.                                 are created.
  199.  
  200. Compress TGA files (RLE)      - With this switch on, the output TGA files
  201.                                 are compressed using the run-length encoding
  202.                                 algorithm which can save lots of hard disk
  203.                                 space.
  204.                                 *Not all applications support the
  205.                                  RLE TGA format.
  206.  
  207. Resample images when morphing - Resampling smooths out the images and
  208.                                 produces a much higher quality morph.
  209.                                 However, it takes much longer with resampling
  210.                                 turned on. Turn it off for test morphs and
  211.                                 turn it on for your final morph.
  212.  
  213. Display images in color       - This specifies whether or not the images are
  214.                                 displayed in shades of gray or in color.
  215.                                 Color is not supported with standard VGA.
  216.  
  217. Prefix for output TGA files   - Click on the name to specify the 4 letter
  218.                                 prefix of the output TGA files. For example,
  219.                                 if the prefix is "MORF" the output files
  220.                                 would be:
  221.                  
  222.                                       MORF0001.TGA
  223.                                       MORF0002.TGA
  224.                                           ...
  225.                                       MORF0013.TGA
  226.  
  227.  
  228. Convert TGA files to a FLI    - This will combine all of your output TGA files
  229.                                 into a FLI animation. The TGA files are not
  230.                                 removed. The FLI filename is the morphing
  231.                                 prefix plus .FLI
  232.                                 *Only registered versions support this option!
  233.  
  234. Text display while morphing   - When using OS/2 or Windows, switching to and
  235.                                 from graphical applications is not always
  236.                                 possible. This option switches SPMORF to text
  237.                                 mode while morphing allowing you to multitask
  238.                                 with it.
  239.  
  240. Display effects when warping  - When in warp only mode (See below) this
  241.                                 option will cause SPMORF to calculate what
  242.                                 the warp would look like on the right side
  243.                                 of the image.
  244.  
  245. Spline mesh when morphing     - When using a spline mesh, SPMORF interpolates
  246.                                 your mesh points to create a higher resolution
  247.                                 mesh resulting in better quality output at the
  248.                                 expense of some more processing time. The
  249.                                 default precision is set to three, meaning
  250.                                 the spline mesh is 3x wider and 3x higher
  251.                                 resulting in a mesh which is 9x denser.
  252.                                 *NOTE: This can sometimes produce very
  253.                                  undesirable output and RESAMPLING should be
  254.                                  turned on.
  255.  
  256. Display full spline mesh      - When using the <Show Spline> button, this 
  257.                                 option will show you the actual mesh used
  258.                                 when warping with a spline mesh. It is useful
  259.                                 to make sure that the splines haven't gone
  260.                                 crazy!
  261.  
  262. ---- Warp only mode ----
  263. The warp only mode works with your left image only. Instead of warping the
  264. images together, it warps to left image to the mesh of the right image
  265. allowing you to stretch your image to create fantastic special effects. With
  266. the "Display effects when warping" (See above) switch on, the right image is
  267. warped on-screen.
  268.  
  269. ---- Disclaimer ----
  270. SPMORF is provided with no gurantee or waranty. I am not responsible for
  271. any damage that SPMORF creates. (Although I don't know how it could)
  272.  
  273. ---- Suggestions? Questions? ----
  274. If you have any suggestions or questions you can contact me the following
  275. ways:
  276.  
  277.     U.S. MAIL-
  278.       Scott H. Pultz
  279.       114-168th AVE NE
  280.       Bellevue, WA
  281.       98008
  282.  
  283.     Internet-
  284.       E-MAIL me at scott@eskimo.com
  285.  
  286.       If you have internet access, I would appreciate it if you used
  287.       this method of contacting me.
  288.  
  289.     Prodigy-
  290.       E-MAIL me at RPTT09B
  291.